<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>trsplit</title>
    <link rel="stylesheet" type="text/css" href="csound.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.78.1" />
    <link rel="home" href="index.html" title="The Canonical Csound Reference Manual" />
    <link rel="up" href="OpcodesTop.html" title="Orchestra Opcodes and Operators" />
    <link rel="prev" href="trshift.html" title="trshift" />
    <link rel="next" href="turnoff.html" title="turnoff" />
  </head>
  <body>
    <div class="navheader">
      <table width="100%" summary="Navigation header">
        <tr>
          <th colspan="3" align="center">trsplit</th>
        </tr>
        <tr>
          <td width="20%" align="left"><a accesskey="p" href="trshift.html">Prev</a> </td>
          <th width="60%" align="center">Orchestra Opcodes and Operators</th>
          <td width="20%" align="right"> <a accesskey="n" href="turnoff.html">Next</a></td>
        </tr>
      </table>
      <hr />
    </div>
    <div class="refentry">
      <a id="trsplit"></a>
      <div class="titlepage"></div>
      <a id="Indextrsplit" class="indexterm"></a>
      <div class="refnamediv">
        <h2>
          <span class="refentrytitle">trsplit</span>
        </h2>
        <p>trsplit — 
      Streaming partial track frequency splitting.
    </p>
      </div>
      <div class="refsect1">
        <a id="idp159837296"></a>
        <h2>Description</h2>
        <p>
      The <span class="emphasis"><em>trsplit</em></span> opcode takes an input containg a TRACKS pv streaming signal (as generated,
      for instance by <span class="emphasis"><em>partials</em></span>) and splits it into two signals according to a k-rate frequency 'split point'. 
      The first output will contain all tracks up from 0Hz to the split frequency and the second will 
      contain the tracks from the split frequency up to the Nyquist.
      It can also, optionally, scale the gain of the output signals by a k-rate amount (default 1). 
      The result is two output signals containing only part of the original spectrum.
    </p>
      </div>
      <div class="refsect1">
        <a id="idp159839808"></a>
        <h2>Syntax</h2>
        <pre class="synopsis">fsiglow, fsighi <span class="command"><strong>trsplit</strong></span> fin, ksplit[, kgainlow, kgainhigh]</pre>
      </div>
      <div class="refsect1">
        <a id="idp159902912"></a>
        <h2>Performance</h2>
        <p>
      <span class="emphasis"><em>fsiglow</em></span> -- output pv stream in TRACKS format containing the tracks below
      the split point.
    </p>
        <p>
      <span class="emphasis"><em>fsighi</em></span> -- output pv stream in TRACKS format containing the tracks above and
      including the split point.
    </p>
        <p>
      <span class="emphasis"><em>fin</em></span> -- input pv stream in TRACKS format
    </p>
        <p>
      <span class="emphasis"><em>ksplit</em></span> -- frequency split point in Hz
    </p>
        <p>
      <span class="emphasis"><em>kgainlow, kgainhig</em></span> -- amplitude scaling of each one of the
      outputs (default 1).
    </p>
      </div>
      <div class="refsect1">
        <a id="idp159908128"></a>
        <h2>Examples</h2>
        <p>
      Here is an example of the trsplit opcode. It uses the file <a class="ulink" href="examples/trsplit.csd" target="_top"><em class="citetitle">trsplit.csd</em></a>.
      </p>
        <div class="example">
          <a id="idp159909984"></a>
          <p class="title">
            <strong>Example 952. Example of the trsplit opcode.</strong>
          </p>
          <div class="example-contents">
            <p>See the sections <a class="link" href="UsingRealTime.html" title="Real-Time Audio"><em class="citetitle">Real-time Audio</em></a> and <a class="link" href="CommandFlags.html" title="Csound command line"><em class="citetitle">Command Line Flags</em></a> for more information on using command line flags.</p>
            <pre class="programlisting">
<span class="csdtag">&lt;CsoundSynthesizer&gt;</span>
<span class="csdtag">&lt;CsOptions&gt;</span>
<span class="comment">; Select audio/midi flags here according to platform</span>
-odac     <span class="comment">;;;realtime audio out</span>
<span class="comment">;-iadc    ;;;uncomment -iadc if realtime audio input is needed too</span>
<span class="comment">; For Non-realtime ouput leave only the line below:</span>
<span class="comment">; -o trsplit.wav -W ;;; for file output any platform</span>
<span class="csdtag">&lt;/CsOptions&gt;</span>
<span class="csdtag">&lt;CsInstruments&gt;</span>

<span class="ohdr">sr</span> <span class="op">=</span> 44100
<span class="ohdr">ksmps</span> <span class="op">=</span> 32
<span class="ohdr">nchnls</span> <span class="op">=</span> 2
<span class="ohdr">0dbfs</span>  <span class="op">=</span> 1

<span class="oblock">instr</span> 1

ain	 <span class="opc">diskin2</span> "beats.wav", 1
fs1,fsi2 <span class="opc">pvsifd</span>  ain, 2048, 512, 1		<span class="comment">; ifd analysis</span>
fst	 <span class="opc">partials</span> fs1, fsi2, .003, 1, 3, 500	<span class="comment">; partial tracking</span>
fslo,fshi <span class="opc">trsplit</span> fst, 1500			<span class="comment">; split partial tracks at 1500 Hz</span>
aout	 <span class="opc">tradsyn</span> fshi, 1, 1, 500, 1	<span class="comment">; resynthesis of tracks above 1500Hz</span>
         <span class="opc">outs</span> aout, aout

<span class="oblock">endin</span>
<span class="csdtag">&lt;/CsInstruments&gt;</span>
<span class="csdtag">&lt;CsScore&gt;</span>
<span class="stamnt">f</span>1 0 8192 10 1	<span class="comment">;sine</span>

<span class="stamnt">i</span> 1 0 2
<span class="stamnt">e</span>
<span class="csdtag">&lt;/CsScore&gt;</span>
<span class="csdtag">&lt;/CsoundSynthesizer&gt;</span>
</pre>
          </div>
        </div>
        <p><br class="example-break" />
    </p>
        <p>
      The example above shows partial tracking of an ifd-analysis signal and
      linear additive resynthesis of the upper part of the spectrum (from 1500Hz). 
    </p>
      </div>
      <div class="refsect1">
        <a id="idp159914832"></a>
        <h2>Credits</h2>
        <p>
      </p>
        <table border="0" summary="Simple list" class="simplelist">
          <tr>
            <td>Author: Victor Lazzarini</td>
          </tr>
          <tr>
            <td>February 2006 </td>
          </tr>
        </table>
        <p>
    </p>
        <p>New in Csound 5.01</p>
      </div>
    </div>
    <div class="navfooter">
      <hr />
      <table width="100%" summary="Navigation footer">
        <tr>
          <td width="40%" align="left"><a accesskey="p" href="trshift.html">Prev</a> </td>
          <td width="20%" align="center">
            <a accesskey="u" href="OpcodesTop.html">Up</a>
          </td>
          <td width="40%" align="right"> <a accesskey="n" href="turnoff.html">Next</a></td>
        </tr>
        <tr>
          <td width="40%" align="left" valign="top">trshift </td>
          <td width="20%" align="center">
            <a accesskey="h" href="index.html">Home</a>
          </td>
          <td width="40%" align="right" valign="top"> turnoff</td>
        </tr>
      </table>
    </div>
  </body>
</html>
